home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / autrd101.zip / MANUAL.DOC < prev    next >
Text File  |  1990-07-02  |  39KB  |  975 lines
  1.  
  2.       ┌────────────────────────────────────────────────────────────────┐
  3.       │                                                                │
  4.       │                                                                │
  5.       │                                                                │
  6.       │                                                                │
  7.       │                         AUTOREAD                               │
  8.       │                                                                │
  9.       │    A program to allow easy reading of large text files         │
  10.       │                       on a computer                            │
  11.       │                                                                │
  12.       │                   Author: David R Grigg                        │
  13.       │                                                                │
  14.       │                        Version 1:                              │
  15.       │                        June 1990.                              │
  16.       │                                                                │
  17.       │                                                                │
  18.       │                                                                │
  19.       │                          MANUAL                                │
  20.       │                                                                │
  21.       │                                                                │
  22.       │                                                                │
  23.       └────────────────────────────────────────────────────────────────┘
  24.  
  25.  
  26.  1:  IMPORTANT NOTICE!
  27.      ═══════════════════════════════════════════════════════════════════════
  28.  
  29.       If you are reading this file on your computer in any other way
  30.       than using AUTOREAD itself, then you are losing out on the
  31.       value of AUTOREAD, and you will also not be able to try out the
  32.       software as you follow the examples given later in this
  33.       document.
  34.  
  35.       To read this document using AUTOREAD, go back to DOS and type:
  36.          AUTOREAD MANUAL.DOC  <and press the enter key>.
  37.  
  38.  
  39.  
  40.       DISCLAIMER
  41.       ══════════
  42.  
  43.       While every effort has been made to free AUTOREAD from errors,
  44.       NO RESPONSIBILITY IS ACCEPTED for any damage that may be caused
  45.       to your computer, disks or data by the use of AUTOREAD.  If this
  46.       makes you nervous, try AUTOREAD out on a floppy disk first.
  47.  
  48.  
  49.  
  50.  
  51.  2:  Introduction
  52.      ════════════════════════════════════════════════════════════════════════
  53.  
  54.       I wrote this program because I often find myself in the
  55.       situation of having a large text file on my computer's hard
  56.       disk which I am using because it has some kind of information
  57.       of value to me.  Usually it is the manual for a shareware
  58.       program.
  59.  
  60.       I adore shareware.  I think the concept of trusting people to
  61.       pay a modest fee for software they genuinely find useful is
  62.       terrific.  And I use a lot of shareware (and pay the
  63.       appropriate registration fees).
  64.  
  65.       But the manuals for most shareware programs are distributed as
  66.       a text file unless you pay extra (and I generally don't).  So I
  67.       end up with very useful manuals in a very NON-useful form: a
  68.       large text file on my hard disk.
  69.  
  70.       Sure, I can print out the manual, but this can consume enormous
  71.       amounts of time, paper and printer ribbons (the QEDIT manual,
  72.       for example, is some 5500 lines long).  And besides, I can
  73.       never find the manual when I want it.  And even if I can,
  74.       finding the information I want can be very hard.
  75.  
  76.       Aren't computers supposed to make life easier?  Yet reading a
  77.       document on a computer screen is still extremely primitive.
  78.       Certainly you can use a useful utility like LIST, but this is
  79.       still missing something.  It's hard to navigate around in a
  80.       large text file, to find the next chapter, or to locate key
  81.       words.  Using the FIND utility in such programs is some help,
  82.       of course, but you have to type in the key word, and hope you
  83.       have spelt and punctuated it properly.
  84.  
  85.       AUTOREAD is my attempt to fill this perceived gap.  It works
  86.       very much like LIST, but it allows you to progressively
  87.       establish landmarks in the text and to go instantly to them.
  88.  
  89.       AUTOREAD allows the creation of several kinds of 'landmarks':
  90.  
  91.          * Chapter Stops
  92.  
  93.          * Pre-defined Keywords
  94.  
  95.          * Temporary Bookmarks
  96.  
  97.       These are all available via pull-down menus for easiest
  98.       possible use.
  99.  
  100.       What all this means is that you can very easily create a
  101.       comprehensive index to a particular text file, enabling you to
  102.       instantly find the section or information you are looking for.
  103.       It makes reading a text file on your computer as easy as
  104.       reading a hard copy, and in some respects easier.
  105.  
  106.  
  107.  3:  Shareware Notice
  108.      ══════════════════════════════════════════════════════════════════════
  109.  
  110.       AUTOREAD took a lot of effort to create.  And I am still
  111.       working on improving it.
  112.  
  113.       Please note that AUTOREAD is not, never has been, and never
  114.       will be free or public domain software.  It is shareware.
  115.  
  116.       The shareware concept is extremely simple.  If you obtain a
  117.       copy of a shareware program, find it useful to you, and wish to
  118.       continue using it, you must send the requested shareware fee to
  119.       the program author.
  120.  
  121.       Shareware relies entirely on trust.  But it is a concept which
  122.       has allowed the creation and distribution of a large body of
  123.       excellent software at very low cost.
  124.  
  125.       If you find AUTOREAD of use, please print out and fill in the
  126.       enclosed LICENSE.DOC document, and send it with the requested
  127.       $15 shareware fee to:
  128.  
  129.                   David R Grigg,
  130.                   1556 Main Road,
  131.                   Research,
  132.                   Victoria 3095
  133.                   Australia.
  134.  
  135.      NOTE:
  136.  
  137.      Most commercial software forbids you to make copies of it.
  138.      But because AUTOREAD is shareware software, you are positively ENCOURAGED
  139.      to share copies of AUTOREAD around, copy it for your friends,
  140.      upload it to bulletin boards, etc.  The only stipulations are that
  141.      all those who use AUTOREAD for longer than a trial period of 14 days
  142.      must pay the required shareware fee, and that AUTOREAD must be
  143.      distributed with all the associated files, being:
  144.  
  145.                     AUTOREAD EXE
  146.                     LICENSE  DOC
  147.                     MANUAL   ARD
  148.                     MANUAL   DOC
  149.                     MANUAL   IDX
  150.                     README   BAT
  151.                     STATS    DOC
  152.                     STATS    EXE
  153.  
  154.  
  155.  
  156.  
  157.  4:  Installing AUTOREAD
  158.      ══════════════════════════════════════════════════════════════════════
  159.  
  160.       AUTOREAD is extremely easy to install.
  161.  
  162.       The only file absolutely necessary to operating AUTOREAD is
  163.       AUTOREAD.EXE, which you should copy either into the same
  164.       directory as the documents you wish to use it on, or
  165.       (especially if you have a hard disk) into a directory which is
  166.       listed in your DOS PATH command (this is usually specified in
  167.       your AUTOEXEC.BAT file).
  168.  
  169.       Many hard disk users have a directory called \TOOLS on their
  170.       hard disk.  This is a good place for AUTOREAD.
  171.  
  172.       To use AUTOREAD on a particular text file (as an example, say a
  173.       file called MANUAL.DOC), you would enter the following at the
  174.       DOS prompt:
  175.  
  176.               AUTOREAD MANUAL.DOC
  177.  
  178.       If you don't enter the file name, you will be prompted for it.
  179.  
  180.  
  181.  5:  Files Created by AUTOREAD
  182.      ══════════════════════════════════════════════════════════════════════
  183.  
  184.       AUTOREAD maintains two different files of its own for every
  185.       text file that you use it on.
  186.  
  187.       If you used it on a document called MANUAL.DOC, for example,
  188.       AUTOREAD would create the following files:
  189.  
  190.            MANUAL.IDX
  191.            MANUAL.ARD
  192.  
  193.       Unless you have changed